Espaces réservés avec définition de format
Le texte de sortie d'un élément peut afficher la valeur d'une variable au moyen d'un espace réservé (%
) avec une définition de format. Lorsque le texte est affiché, la valeur de la variable est insérée à la place de l'espace réservé. Le type de données dans la définition de format et celui de la variable doivent être identiques.
La chaîne affichée est répertoriée dans le Variable de texte propriété.
propriété de l'élément. La variable est répertoriée dans leLes utilisateurs de la visualisation peuvent spécifier un texte dans un élément, dans lequel le texte, par exemple, est stocké et affiché comme une variable de sortie de texte. La saisie utilisateur doit correspondre au format d'entrée. Le type de données de la variable de sortie de texte doit correspondre au type de données défini pour le format d'entrée.
La définition du format du texte d'entrée se trouve dans le Configuration d'entrée dialogue, dans Saisie de texte, dans le Écrire une variable action d'entrée. La variable est répertoriée dans le Variable de texte propriété.
Entier
La définition de format pour un entier a le format suivant :
% <drapeaux> <nombre minimum de chiffres> <type>
Types de données recommandés : BYTE | WORD | DWORD | LWORD | SINT | USINT | INT | UINT | DINT | UDINT | LINT | ULINT
Syntaxe | Exemple | Description | Exemple de visualisation |
---|---|---|---|
<drapeaux> | Optionnel et combinable | Code: Variable de texte propriété: | |
|
| Alignement justifié à gauche, par rapport à la largeur minimale du nombre (spécifiée en nombre minimal de chiffres) | Texte propriété: |
|
| Sortie toujours avec un signe | Texte propriété: Sortir: |
|
| Les places sont remplies par un 0 jusqu'à ce que le nombre minimum de places (y compris le signe) soit atteint | Texte propriété: |
<nombre minimum de chiffres> |
| Facultatif Nombre minimum de places |
Syntaxe | Exemple | Description | Exemple de visualisation |
---|---|---|---|
<type> | Requis | ||
|
| Sortie sous forme de nombre décimal entier | Code: Texte propriété: Variable de texte propriété: Sortir: |
| Code: Texte propriété: Variable de texte propriété: Sortir: | ||
|
| Sortie sous forme de nombre binaire entier non signé sans préfixe | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Sortie sous forme de nombre octal entier non signé sans préfixe | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Sortie sous forme de nombre hexadécimal 32 bits non signé avec les chiffres a à f (minuscules) sans préfixe et sans séparateur | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Sortie sous forme de nombre hexadécimal 32 bits non signé avec les chiffres A à F (majuscules) sans préfixe et sans séparateur | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Sortie sous forme de nombre hexadécimal non signé de 64 bits avec les chiffres a à f (minuscules) sans préfixe et sans séparateur Note: Types de données recommandés : | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Sortie sous forme de nombre hexadécimal non signé de 64 bits avec les chiffres A à F (majuscules) sans préfixe et sans séparateur Types de données recommandés : | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Sortie sous forme de nombre décimal entier non signé Types de données recommandés : | Code: Texte propriété: Variable de texte propriété: Sortir: |
Nombre à virgule flottante en notation à virgule fixe
Les nombres à virgule flottante peuvent être affichés sous forme de nombre décimal en notation à virgule fixe. La définition de format pour cela est la suivante :
% <drapeaux> <nombre minimum de chiffres> . <précision> f
Types de données recommandés pour ce type de variable d'espace réservé : REAL | LREAL
Syntaxe | Exemple | Description | Exemple de visualisation |
---|---|---|---|
<drapeaux> | Optionnel et combinable | ||
|
| Alignement justifié à gauche, par rapport au nombre minimum de chiffres | |
|
| Toujours avec un signe, également pour les nombres positifs | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Les cases sont remplies avec un 0 jusqu'à ce que le nombre minimum de cases (y compris le signe et le point décimal) soit atteint | Code: Texte propriété: Variable de texte propriété: Sortie : |
<nombre minimum de chiffres> . <précision> | Facultatif Lorsqu'il n'est pas spécifié, le numéro est affiché au format standard 1,6 | ||
<nombre minimum de chiffres> |
| Nombre minimum de chiffres, y compris le signe et le point décimal Exemple : 12 | Code: Texte propriété: Variable de texte propriété: Sortie : |
<précision> |
| Précision dans les positions et le point décimal Exemple : 3 | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Requis Identificateur de format pour l'affichage décimal avec le point décimal | Code: Texte propriété: Variable de texte propriété: Sortir: |
Nombre à virgule flottante en notation exponentielle
Les nombres à virgule flottante peuvent être affichés en notation exponentielle normalisée en base 10. La définition de format pour la notation exponentielle a le format suivant :
% <drapeaux> <nombre minimum de chiffres> . <précision> <type>
Types de données recommandés pour ce type de variable d'espace réservé : REAL | LREAL
Syntaxe | Exemple | Description | Exemple de visualisation |
---|---|---|---|
<drapeaux> | Optionnel et combinable | ||
|
| Alignement justifié à gauche, par rapport au nombre minimum de chiffres | |
|
| Toujours avec un signe, également pour les nombres positifs | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Les cases sont remplies avec un 0 jusqu'à ce que le nombre minimum de cases (y compris le signe et le point décimal) soit atteint | Code: Texte propriété: Variable de texte propriété: Sortir: |
<nombre minimum de chiffres> . <précision> | Facultatif Lorsqu'elle n'est pas spécifiée, la mantisse est générée au format standard 1.6 | ||
<nombre minimum de chiffres> |
| Nombre minimum de chiffres, y compris le signe (pour la mantisse et l'exposant), le point décimal et les exposants ( Exemple : 12 | Code: Texte propriété: Variable de texte propriété: Sortir: |
<précision> |
| Précision de la mantisse en nombres décimaux et du point décimal Exemple : 3 | Code: Texte propriété: Variable de texte propriété: Sortir: |
<type> | Requis | ||
|
| Afficher avec | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Afficher avec | Code: Texte propriété: Variable de texte propriété: Sortir: |
Temps en nombres entiers
Avis de compatibilité
Afin d'obtenir l'affichage habituel, dans la version V3.5 SP17 et supérieure, en règle générale, trois chiffres sont utilisés pour la sortie des fractions de seconde (ms/µs/ns). Exemple : Dans %t[dd-HH:mm:ss:ms]
, ms
est spécifié avec trois chiffres pour les millisecondes. À cet effet, le nombre ms à deux chiffres est précédé d'un zéro. Si une sortie à deux chiffres est souhaitée (comme avant V3.5 SP17), une définition spéciale du compilateur doit être définie dans les propriétés du compilateur de l'application : VISU_MILLISEC_NOLEADING_ZERO
.
Si le texte de sortie dans le %t
avec une identification pour une unité de temps, une heure, une durée ou un intervalle de temps est alors généré. La variable d'espace réservé est affectée dans le Variable de texte propriété.
L'espace réservé pour un temps par unité de temps a le format suivant :
%t[ <texte> <temps en unité> <texte> ]
Types de données recommandés : TIME
, LTIME
Syntaxe | Exemple | Description | Exemple de visualisation |
---|---|---|---|
<temps en unité> | Requis Identification d'une unité de temps Filtre à partir de la valeur temporelle le nombre complet de l'unité de temps spécifiée (jours, heures, minutes, secondes, millisecondes) Pour les valeurs temporelles de 64 bits, également les microsecondes et les nanosecondes | ||
Valable pour les exemples suivants : Code: Variable de texte propriété: | |||
|
| Nombre de jours, sans zéro préfixé | Texte propriété: Sortir: |
|
| Nombre de jours entiers, précédé d'un zéro | Texte propriété: Sortir: |
|
| Nombre d'heures (0–23) | Texte propriété: Sortir: |
|
| Nombre d'heures (00–23) | Texte propriété: Sortir: |
|
| Nombre d'heures (0–23) | Texte propriété: Sortir: |
|
| Nombre d'heures (00–23) | Texte propriété: Sortir: |
|
| Nombre de minutes (0–59), sans zéro non significatif | Texte propriété: Sortir: |
|
| Nombre de minutes (00–59), avec zéro non significatif | Texte propriété: Sortir: |
|
| Nombre de secondes (00–59), sans zéro non significatif | Texte propriété : Sortir: |
|
| Nombre de secondes (00–59), avec zéro non significatif | Texte propriété : Sortir: |
|
| Nombre de secondes fractionnaires, en millisecondes (0–999) | Texte propriété : Sortir: |
|
| Nombre de secondes fractionnaires, en microsecondes (0–999) Uniquement pour le type de données | Texte propriété : Sortir: Remarque : le dépassement est autorisé dans la plus grande unité de temps d'une définition. |
|
| Nombre de secondes fractionnaires, en nanosecondes (0–999) Uniquement pour le type de données | Texte propriété : Sortir: Remarque : le dépassement est autorisé dans la plus grande unité de temps d'une définition. |
<texte> |
| Facultatif Les chaînes, qui sont spécifiées entre parenthèses, sont incluses dans la sortie Remarque : si une chaîne doit être générée, qui correspond à une identification pour une unité de temps ou qui contient des identifications pour des unités de temps, alors la chaîne doit être placée entre guillemets droits simples. | Texte propriété : Sortir: Texte propriété : Sortir: |
À l'intérieur des parenthèses, les identifications des unités de temps peuvent apparaître un nombre illimité de fois et peuvent être échangées avec n'importe quelle chaîne.
Syntaxe | Exemple | Description | Exemple de visualisation |
---|---|---|---|
| Format horaire pour toutes les unités de temps, avec le séparateur habituel entre les deux | Texte propriété : Sortir: | |
| Format avec des chaînes supplémentaires qui doivent être affichées, sans tenir compte des identifications des unités de temps Ces types de chaînes sont entourées de guillemets droits simples. | Texte propriété : Sortir: |
Heure sous forme de nombre décimal
Types de données recommandés : TIME
, LTIME
Dans la définition du format, la durée <time in unit>
peut être identifié avec l'identification de la décimale <number of decimal places>
. Le résultat est que la durée est formatée sous forme de nombre décimal (avec des décimales) dans l'unité de temps spécifiée. Cela est possible pour les formats de temps suivants : HH | H | hh | h| mm | m | ss | s | ms |us | ns
Cela peut être utile pour la saisie utilisateur.
L'espace réservé pour une période de temps sous forme de nombre décimal a le format suivant :
%t[ <temps en unité> <nombre de décimales>]
Syntaxe | Exemple | Description | Exemple de visualisation |
---|---|---|---|
<temps en unité> | Requis Identification d'une unité de temps qui formate la valeur de temps dans l'unité de temps spécifiée (jours, heures, minutes, secondes, millisecondes) sous forme de nombre décimal Pour les valeurs temporelles de 64 bits, également les microsecondes et les nanosecondes | ||
<nombre de décimales> | Requis Nombre maximal de décimales ( Remarque : Même si les décimales ne sont pas souhaitées pour la saisie ou l'affichage, au moins le nombre | ||
Les exigences s'appliquent aux exemples suivants : Code: Variable de texte propriété: | |||
|
| Valeur temporelle (en heures) sous forme de nombre décimal Nombre d'heures (0–23) Exemple : 4 | Texte propriété: Saisie utilisateur : Valeur temporelle : |
|
| Valeur temporelle (en minutes) sous forme de nombre décimal Exemple : 2 | Saisie utilisateur : Valeur temporelle |
|
| Valeur temporelle (en secondes) sous forme de nombre décimal Exemple : 3 | Saisie utilisateur : Valeur temporelle |
| Exemple : 0 | Saisie utilisateur : Valeur temporelle | |
|
| Valeur temporelle (en millisecondes) sous forme de nombre décimal Exemple : 3 | Saisie utilisateur : Valeur temporelle |
|
| Valeur temporelle (en microsecondes) sous forme de nombre décimal Exemple : 3 | Saisie utilisateur : Valeur temporelle |
|
| Valeur temporelle (en nanosecondes) sous forme de nombre décimal Exemple : 0 | Saisie utilisateur : Valeur temporelle |
Le temps du système
Si une variable n'est pas affectée à un espace réservé avec une définition de format, l'heure système est affichée.
Syntaxe | Exemple | Description | Exemple de visualisation |
---|---|---|---|
|
| Sortie de l'heure système actuelle Exigence: Non la variable est spécifiée sous le Variable de texte propriété. | Texte propriété: Variable de texte propriété: vide Sortir: |
|
| Facultatif Sortie du décalage de l'heure du système local en temps universel (UTC) | Texte propriété: En fonction de la variable UTC
|
Astuce
Vous pouvez changer par programmation le fuseau horaire local de l'heure système vers l'heure universelle (UTC).
Lorsque la variable VisuElems.Visu_DateTime.DisplayUTC
est réglé sur TRUE
, l'heure système est affichée en temps universel (UTC). Par défaut, la variable VisuElems.Visu_DateTime.DisplayUTC
est réglé sur FALSE
afin que l'heure du système soit affichée dans le fuseau horaire local.
Pour l'affichage des valeurs de date et d'heure, vous pouvez étendre la chaîne de format correspondante avec le code du fuseau horaire Z
. Pour une sortie en heure système locale, le décalage est alors affiché en temps universel (UTC). Par exemple, dd:MM:yyyy HH:mm:ss:ms:Z
sorties 01.08.2021 12:00:00:001:+02:00
Lorsque l'heure universelle (UTC) est affichée, le code UTC est également affiché. 01.08.2021 10:00:00:001:Z
Date et l'heure
Avis de compatibilité
Afin d'obtenir l'affichage habituel, dans la version V3.5 SP17 et supérieure, en règle générale, trois chiffres sont utilisés pour la sortie des fractions de seconde (ms/µs/ns). Exemple : Dans %t[dd-HH:mm:ss:ms]
, ms
est spécifié avec trois chiffres pour les millisecondes. Un zéro est ajouté au début des deux chiffres ms
numéro.Si une sortie à deux chiffres est souhaitée (comme avant V3.5 SP17), une définition de compilateur spéciale doit être définie dans les propriétés du compilateur de l'application : VISU_MILLISEC_NOLEADING_ZERO
.
Types de données recommandés pour les définitions de date et d'heure : DATE
, DATE_AND_TIME
, DT
, LDATE
, LDATE_AND_TIME
, LDT
, LTOD
, TIME_OF_DAY
, TOD
Par défaut, les noms des jours et des mois sont affichés en anglais. Lorsque des textes localisés sont utilisés, les System
La liste de textes doit être complétée. Cette liste de textes est automatiquement créée dans le POU voir quand le %t
Un espace réservé est utilisé. Les termes anglais doivent être utilisés comme identifiants ici. La localisation peut être effectuée à la fois pour les noms abrégés et les noms complets.
La chaîne de format pour une définition de date et d'heure a le format suivant :
%t[ <unité de date et d'heure> ]
Syntaxe | Exemple | Description | Exemple de visualisation |
---|---|---|---|
<unité de date et d'heure> | Requis Identification des unités de date et d'heure Filtre à partir de la valeur temporelle (type de données : date et heure) la valeur de l'unité spécifiée (année, mois, jour, heure, minute, millisecondes) Pour les valeurs de date et d'heure 64 bits, également les microsecondes et les nanosecondes | ||
|
| Année avec siècle | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Année sans siècle (00–99) | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Année sans siècle (0–99) | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Mois comme nom complet | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Mois comme nom abrégé | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Mois sous forme de nombre (01–12) | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Mois sous forme de nombre (1–12) | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Jour de la semaine sous forme de numéro (1 = lundi – 7 = dimanche) | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Jour de la semaine en tant que nom complet | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Jour de la semaine sous forme de nom abrégé | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Jour du mois sous forme de nombre (01–31) | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Jour du mois sous forme de nombre (1–31) | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Jour de l'année sous forme de numéro (001–366) | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Heure au format 24 heures (00–23) Exemple
| Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Heure au format 12 heures (01–12) Exemple
| Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Abréviation A ou P au format 12 heures Un pour P pour Exemple
| Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Abréviation AM ou PM au format 12 heures Je suis pour PM pour Exemple
| Code: Texte propriété: Variable de texte propriété: Sortir: |
À l'intérieur des parenthèses, les identifications des unités de date et d'heure peuvent apparaître un nombre illimité de fois et peuvent être échangées avec n'importe quelle chaîne.
Syntaxe | Exemple | Description | Exemple de visualisation |
---|---|---|---|
| Date et jour de la semaine avec séparateurs entre les deux | Code: Texte propriété: Variable de texte propriété: Sortir: | |
| Moment de la journée | Code: Texte propriété: Variable de texte propriété: Sortir: | |
| Si des chaînes de caractères correspondant à une définition de format doivent être générées, elles doivent être représentées entre guillemets droits simples. | Texte propriété: Sortir: |
Texte
Types de données recommandés pour la variable d'espace réservé : STRING
, WSTRING
La définition de format pour les chaînes et les chaînes ont le format suivant :
% <type>
Syntaxe | Exemple | Description | Exemple de visualisation |
---|---|---|---|
<type> | |||
|
| Sortie d'un seul caractère dans le jeu de caractères ASCII | Code: Texte propriété: Variable de texte propriété: Sortir: |
|
| Sortie de la chaîne Types de données recommandés : | Code: Texte propriété: Variable de texte propriété: Sortir: Lorsque le codage UTF-8 est activé pour le Pour plus d'informations, voir : Boîte de dialogue : Paramètres du projet : Options de compilation |
Signe de pourcentage
Spécification de format pour la sortie d'un signe de pourcentage
Syntaxe | Exemple | Description | Exemple de visualisation |
---|---|---|---|
|
| Sortie du signe de pourcentage | Avec une variable d'espace réservé : Code: Texte propriété: Variable de texte propriété: Sortir: |
Texte propriété: Sortir: |